home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / boot / mkick17.lha / README < prev    next >
Encoding:
Text File  |  1995-01-29  |  7.8 KB  |  212 lines
  1. ==============================================================================
  2.  
  3.                          MJSoft's Kicker -- MKick 1.7
  4.  
  5.               (c) 1992-1995 Martin Mares, MJSoft System Software
  6.  
  7. ==============================================================================
  8.  
  9.  
  10. What is MKick
  11. -------------
  12.  
  13.    MKick is a replacement of KickIt, ZKick and LKick kickers for use on
  14. machines with kickstart 1.2 or 1.3 in ROM (It also tries to be as powerful
  15. as SinSoft's SKick).
  16.  
  17.    The main advantages of MKick are:
  18.  
  19.  - ability to relocate any Kickstart to CHIP, FAST (C0-RAM), NON-AUTOCONFIG
  20.    RAM or EXPANSION RAM if a relocation table is supplied.
  21.  
  22.  - standard operation (like ZKick) if the relocation table is not available.
  23.  
  24.  - reading of both KickIt and ROM Image Kickstart formats (encrypted
  25.    beta-ROMs for A600 must be converted by MakeKick)
  26.  
  27.  - patch function using supplied patch table (may correct known Kickstart bugs).
  28.  
  29.  - can be started from both the command line and the Workbench.
  30.  
  31.  - Graphic User Interface (GUI).
  32.  
  33.  - Small code size, because it's written completely in assembly.
  34.  
  35.  - loaded Kickstart survives user reset and crashes (when the ExecBase is not
  36.    destroyed).
  37.  
  38.  - C0-RAM salvage: many Kickstarts perform destructive tests of C0-RAM (FAST
  39.    RAM). MKick stores critical bytes in its own storage and restores their
  40.    contents after memory tests.
  41.  
  42.  - If you have Kickstart 39.106 or higher, the alert timing constant
  43.    (execbase+$20E) won't be lost during reboot.
  44.  
  45.  - Non-autoconfig can be added automatically without using special resident
  46.    utilities.
  47.  
  48.  - ROM Kickstart can be relocated to RAM. This speeds up system operation on
  49.    the most of accelerated systems (e.g. GVP A530 Turbo). In this case, you
  50.    needn't the Kickstart image file, MKick will load it directly from your ROM.
  51.  
  52.  - Waits for all disks to be validated before performing any operation.
  53.  
  54.  - New memlist named Kickstart is created if the KS image is not stored in
  55.    one of original memlists. This prevents MonAm from treating KS image
  56.    as out-of-memory space.
  57.  
  58.  - Ability to get rid of resident modules by simply pressing the left mouse
  59.    button at correct time (see below).
  60.  
  61.  
  62. Copyright
  63. ---------
  64.  
  65.    MKick and all the utilities in this package, including their documentation,
  66. with the exception of KickStat are Copyright (C) 1995 Martin Mares, Prague,
  67. Czech Republic.
  68.  
  69.    The  KickStat  utility  is  Copyright  (C) 1995 SinSoft and is included with
  70. permission of its author.
  71.  
  72.    This  archive  can  be  freely  redistributed as long as all of its files are
  73. included   in   their   original   form  without  any  additions,  deletions  or
  74. modifications  (excluding addition of other README-style files and icons) and no
  75. more  than a nominal fee is charged for its distribution.  All copyright notices
  76. in  the  programs and accompanying documentation files must remain intact.  It's
  77. especially  forbidden  to add various '.displayme' files and BBS advertisements.
  78. This style of distribution is generally known as FREEWARE.
  79.  
  80.    There's one exception to these rules -- the author allows all the utilities
  81. to be included in SKick archives.
  82.  
  83.    This package is provided as is, any warranties cannot be applied.  Any
  84. usage of this program or other parts of this archive will be done at your own
  85. risk!
  86.  
  87.  
  88. Contents
  89. --------
  90.  
  91.    README             - this file
  92.    README.BUGREPORTS  - how to write MKick bug reports
  93.    README.31          - some additional information about 3.1 Kickstarts
  94.    HISTORY            - history of development
  95.  
  96.    MKick              - the kicker itself
  97.    MKick.info         - icon
  98.  
  99.    MakeKick           - utility for creation of Kickstart header files
  100.    Kick2RTB           - converts Kickstart header files to SKick format
  101.    MakeKickDisk       - makes special boot disk for fast booting of Kickstarts
  102.    SwitchScript       - utility for easy switching of startup scripts
  103.    SumKick            - calculates checksum of Kickstart image
  104.    KickStat           - shows information about currently running Kickstart
  105.    KickInfo           - utility showing information about Kickstart file
  106.  
  107.    *.doc              - Documentation
  108.  
  109.    KSHD/*.kick        - Kickstart headers for various Kickstarts
  110.    KSHD/*.kshd        - source files for Kickstart headers
  111.  
  112.    Delta/*            - delta files to recover patched Kickstarts
  113.                         (see delta/README for more info)
  114.  
  115.  
  116. Included Kickstart headers
  117. --------------------------
  118.  
  119.    The  Kickstart  header  files containing the relocation table and information
  120. needed  to load the Kickstart are supplied for following Kickstarts:
  121.  
  122.    Kick34005.A500            standard 1.3 for A500
  123.    Kick37175.A500            standard 2.04 for A500+
  124.    Kick39046.A500.BETA       beta-version of 3.0         (*)
  125.    Kick39106.A1200           standard 3.0 for A1200
  126.    Kick39110.A500.BETA       beta-version of 3.0         (*)
  127.    Kick39115.A3000.BETA      beta-version of 3.0         (*)
  128.    Kick39115.A3000SK.BETA    beta-version of 3.0, SuperKickstart file (*)
  129.    Kick40003.A3000.BETA      beta-version of 3.0, SuperKickstart file (*)
  130.    Kick40038.A600.BETA       beta-version of 3.1     (*)
  131.    Kick40063.A600            final version of 3.1 ??
  132.    Kick40068.A600            final version of 3.1 ??
  133.    Kick40070.A3000           final version of 3.1 for A3000 (requires 68030+881)
  134.  
  135. (*)- Available only to official developers.
  136.  
  137.    For 3.1 Kickstarts, see notes in README.3.1.
  138.  
  139.    If you have a Kickstart which is not included in this list, try to download
  140. latest version of SKick if it contains RTB and PAT files for your Kickstart
  141. and convert them by the MakeKick utility (AUTO option).
  142.  
  143.  
  144. System requirements:
  145. --------------------
  146.  
  147.   - Amiga 500, 1000 or 2000
  148.  
  149.   - Minimally 1 meg of RAM (all possible combinations)
  150.  
  151.   - Kickstart 1.2 or 1.3 in ROM
  152.  
  153.   - arp.library in the LIBS: directory
  154.  
  155.  
  156. Installation:
  157. -------------
  158.  
  159.    (1) Create DEVS:Kickstarts and copy all your Kickstart images to it. This
  160.        directory is searched automatically in the GUI mode (can be overriden
  161.        by the KICKDIR option if you want).
  162.  
  163.    (2) Find proper Kickstart header files (you may find a list of them above).
  164.        Rename Kickstart files to match the names of the header files -- for
  165.        kick39115.A3000.BETA.kshd, the Kickstart image should be renamed to
  166.        kick39115.A3000.BETA. (It's also possible to rename the header files
  167.        according to names of Kickstart images, but it's a bit confusing.)
  168.  
  169.        THERE ARE NO KICKSTART IMAGES IN THIS ARCHIVE
  170.  
  171.        If you don't know the exact name of .kick file to be used, consult the
  172.        KickInfo utility (see its doc for how to do it).
  173.  
  174.    (3) Copy the executable files to some place, preferably to some that is
  175.        included in PATH. It's better to copy the MKick executable itself to
  176.        C: to allow using it before any paths are set.
  177.  
  178.    (4) If you want MKick to work automatically, insert it as a FIRST line of
  179.        your Startup-sequence. It allows MKick to handle all operations requiring
  180.        system reboot (switching from one Kickstart in RAM to another one etc.)
  181.        without user intervention.  When you hold down the left mouse button
  182.        during system reboot, the GUI screen will appear.
  183.  
  184.    (5) If you want your startup scripts to be switched according to Kickstart
  185.        version, install the SwitchScript utility (see its .doc for how to do it)
  186.  
  187.  
  188. Thanks:
  189. -------
  190.  
  191.  - to Commodore-Amiga for the Operating System.
  192.  
  193.  - to SinSoft for his SKick and a lot of good ideas.
  194.  
  195.  - to Tomas Zikmund, Petr Cisar and Stefan Stuntz for beta-testing.
  196.  
  197.  - to many people for sending me their bug reports
  198.  
  199.  
  200. Final words:
  201. ------------
  202.  
  203.    Known bugs: MKick probably doesn't work with 68040 CPU, because I have no
  204.                beta-testers with such machine and I have no documentation for
  205.                this CPU.
  206.  
  207.    Send bug reports and comments to mjsoft@k332.feld.cvut.cz
  208.     (Before sending bug reports, you should read the README.BUGREPORTS file).
  209.  
  210.    Excuse me for my bad English and all bugs.
  211.  
  212.